Skip to main content
POST
Create a creative.

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Body

application/json
name
string
required
Minimum string length: 1
type
enum<string>
required
Available options:
banner,
video,
native
advertiser_domain
string | null

Advertiser domain using this creative.

advertiser_id
string<uuid> | null

Advertiser ID using this creative.

banner
BannerInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

description
string | null

Optional description of the creative.

end_date
string<date-time> | null
ext
any
default:{}

extension for the creative

height
integer
default:0
Required range: x >= 0
native
NativeInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

start_date
string<date-time> | null
status
enum<string>
default:inactive

Status of the creative.

Available options:
inactive,
active
video
Video · object | null

Video creative content.

width
integer
default:0
Required range: x >= 0

Response

Successful Response

created_at
string<date-time>
required
height
integer
required

Height of the creative in pixels.

Required range: x >= 0
id
string<uuid>
required

Unique identifier for the creative (UUID v7).

name
string
required

Human-readable name of the creative.

owner_id
string<uuid>
required

User ID of the admin/operator who created the creative.

type
enum<string>
required

Type of the creative (e.g., "banner", "video", "native").

Available options:
banner,
video,
native
updated_at
string<date-time>
required
width
integer
required

Width of the creative in pixels.

Required range: x >= 0
advertiser_domain
string | null

Advertiser domain using this creative.

advertiser_id
string<uuid> | null

Advertiser ID using this creative.

banner
BannerResponse · object | null

읽기/응답용 DTO — 저장된 AdCOM Banner를 그대로 노출. 검증 없음.

description
string | null

Optional description of the creative.

end_date
string<date-time> | null
ext
any
default:{}

extension for the creative

native
Native · object | null

Native creative content

no
integer | null
start_date
string<date-time> | null
status
enum<string>
default:inactive

Status of the creative.

Available options:
inactive,
active
video
Video · object | null